Skip to content

Migration: Docosaurus > Astro Starlight, Device Detail Pages, ...#1063

Open
naltatis wants to merge 7 commits into
mainfrom
infra/next
Open

Migration: Docosaurus > Astro Starlight, Device Detail Pages, ...#1063
naltatis wants to merge 7 commits into
mainfrom
infra/next

Conversation

@naltatis
Copy link
Copy Markdown
Member

@naltatis naltatis commented May 18, 2026

Migrating from Docosaurus to Astro Starlight. Docoraurus development has stalled of the last year. Builds are slow, multi language was never optimal, creating dynamic content (per-device docs) was only possible via custom generator script, npm audit foo, ... . That's why we're moving to an alternative platform.

Preview:

https://evcc-docs.pages.dev/en/

Improvements:

🏃‍♂️‍➡️ faster page loads, no client side javascript needed
🇬🇧🇩🇪 proper i18n concept, sibling en/de folder, en default language (redirects for old links)
🚀 fast builds, 23s for both langs and 1800 pages (see per-device page below)
🏷️ better content structuring features (steps, badges, ...)
🔎 replaced Algolia Search with Pagefind (browser local solution, more privacy)
✏️ blog via Starlight Blog
🔌 improved openapi viewer, multi page, direct link capable, no manual styling \cc @Maschga
🤖 add llms.txt via plugin

New features:

🚖 per-device pages (replaces #814, fixes #632)
🔥 faster page loads (especially charger / meter overview), better overview
🕷️better seo
📑 parameter table incl. help text, format, defaults, ...
👨‍💻 yaml samples still exist (advanced toggle)
🌓 nightly toggle on device level (appears when nightly template has changes compared to release), fixes #530
🔗 edit page for device detail pages links to source template in core repo (fixes #755)
🎨 introducing evcc-io/icons, shown on detail page if they exist
🌟 improved feature (1p3p, mA, ...) visualization in list, fixes #622

Cleanup:

🗑️ remove evcc configure references
🗃️ move evcc.yaml refs and examples to the end of pages

Screenshots:

Device detail page (with icon)

device detail icon

Charger list (features)

charger list features

Meter list (aligned features, usages)

meter liste complete

Meter list (groups)

meter list groups

Device details (modbus toggle)

device detail modbus

Nightly switch

nightly.webm

Device params (choices)

param options

Native badges (plugins, dark)

plugin dark badge

Steps (light)

steps light

Steps (dark)

steps dark

Todos

  • navigation styling
  • feature filter (meter, charger, ...)

Comment thread public/openapi.yaml
@naltatis naltatis requested review from andig and premultiply May 18, 2026 17:09
@naltatis
Copy link
Copy Markdown
Member Author

\cc @VolkerK62

@naltatis naltatis marked this pull request as ready for review May 18, 2026 17:10
@Maschga
Copy link
Copy Markdown
Contributor

Maschga commented May 19, 2026

feature filter (meter, charger, ...)

Wie kann ich wie in der "alten" Doku nach Features filtern? Ich finde den Button/die Funktion nicht. Wurde diese Funktion durch die Filterleisten ersetzt?

Ich fände es auch noch schön, wenn der Blog wie in der "alten" Doku wieder nach der Jahreszahl gruppiert wäre. Das macht es für mich übersichtlicher.

Ansonsten top!

@naltatis
Copy link
Copy Markdown
Member Author

Ich fände es auch noch schön, wenn der Blog wie in der "alten" Doku wieder nach der Jahreszahl gruppiert wäre. Das macht es für mich übersichtlicher.

Bietet das Plugin (wenn ichs nicht übersehen habe) leider nicht an :/

Wie kann ich wie in der "alten" Doku nach Features filtern? Ich finde den Button/die Funktion nicht. Wurde diese Funktion durch die Filterleisten ersetzt?

Ja ist aktuell nicht mehr drin. Vielleicht fällt mir noch was gutes ein, wie man das eleegant hier abbilden kann.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants